home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / disk / misc / UnADF.readme < prev   
Encoding:
Text File  |  2000-01-02  |  5.5 KB  |  149 lines
  1. Short:    Extract files out of DOS ADF files.
  2. Author:   Andrew Bell <andrew.ab2000@bigfoot.com>
  3. Uploader: Andrew Bell <andrew.ab2000@bigfoot.com>
  4. Version:  1.1
  5. Type:     disk/misc
  6. Requires: 020+, OS 3.0+, 2MB of fast memory recommended.
  7.  
  8. Introduction
  9. ------------
  10.  
  11. UnADF is a Shell tool that allows you to extract the files out of an
  12. AmigaDOS OFS/FFS formatted ADF disk image file. With the various versions
  13. of UAE available, ADF files have become very common. An ADF file is simply
  14. the entire data of an Amiga floppy disk saved as a file. UnADF allows you
  15. to save the entire contents (i.e files & dirs) of these ADF files to your
  16. harddrive.
  17.  
  18. AmigaDOS ADF files are very similar to archives, they contain files just
  19. like archives do, but weren't actually intended for this purpose.
  20.  
  21. Features
  22. --------
  23.  
  24. UnADF supports OFS, OFS-Intl, OFS-DirCache, FFS, FFS-Intl and FFS-DirCache
  25. ADF floppy formats. It also supports hard links to files and directories,
  26. that are normally created with the AmigaDOS "makelink" command.
  27.  
  28. With the help of xfdmaster.library, UnADF can decompress compressed ADF
  29. files before extracting. xfdmaster.library is not included with UnADF, but
  30. can be obtained from Aminet. UnADF does not require xfdmaster.library and
  31. will work without it.
  32.  
  33. Notes
  34. -----
  35.  
  36. Softlinks are currently not supported in this version of UnADF, and all
  37. checksums are ignored, so always check that your data is valid after you
  38. extract it.
  39.  
  40. UnADF might slow down a little if it encounters an ADF with heavily
  41. fragmented hash chains or data blocks.
  42.  
  43. UnADF does not support high density floppy image dumps, only standard DD
  44. ADF type (i.e. If it's 901120 bytes long, it should work).
  45.  
  46. Background on UnADF 
  47. -------------------
  48.  
  49. The actual program evolved from a test program I was writing for another
  50. one of my projects, FloppyFlux. Version 2 of FF is currently in development
  51. and allows the user to access the contents of backed-up ADF images. I 
  52. received many e-mails from people requesting this feature to be added to
  53. FF, but since I'm still in the middle of developing FF 2, and it won't
  54. be finished for a few months yet, I decided to release this small tool to
  55. the public.
  56.  
  57. But floppies are obsolete!
  58. --------------------------
  59.  
  60. Just because the medium itself is becoming obsolete, it doesn't mean that the
  61. data on those disks is obsolete too. For example, I bought 9 or 10 commercial
  62. Amiga titles fairly recently, and half of these came on floppy disks! I use
  63. FloppyFlux to store backups of these disks on my harddrive as ADFs. If I
  64. need to get files from them, I use UnADF. I try to avoid them little plastic
  65. floppy disks as much as possible, I'm only interested in the data they
  66. hold. ;)
  67.  
  68. You can get the latest version (currently 1.2) of FloppyFlux on Aminet at:
  69. disk/bakup/FloppyFlux.lha, this version will eventually be replaced by
  70. version 2, which is due sometime early 2000.
  71.  
  72. Non-DOS ADF files
  73. -----------------
  74.  
  75. Not all ADFs are formatted with FFS/OFS, but instead use their own custom
  76. disk format. This includes most games and demos, so UnADF will report these
  77. types of ADF files as non-DOS/corrupt or will report the rootblock as
  78. invalid.
  79.  
  80. Requirements
  81. ------------
  82.  
  83. 020+, OS 3.0+, 2MB of fast memory recommended.
  84.  
  85. UnADF is *VERY* memory hungry, especially while decompressing ADFs.
  86.  
  87. Usage
  88. -----
  89.  
  90. UnADF is very easy to use. There are currently two parameters:
  91.  
  92. LIST - Switch, this tells UnADF to list the contents of the ADF only.
  93.  
  94. DEST - The destination directory. A little note: UnADF doesn't actually
  95.        save the contents directly to this directory, but instead creates
  96.        a sub-directory inside it, with the name of the disk.
  97.  
  98.        So for example, if an ADF was formatted with the name "Empty", UnADF
  99.        will use this name as the name of the sub-directory. If a sub-
  100.        directory already exists with this name, then UnADF will append an
  101.        extension in the form of <dirname>.<number>, e.g. Empty.001.
  102.  
  103. Examples: UnADF Store:MyADF.adf DEST=ram:     ; save dir to ram:
  104.           UnADF dh1:ADisk LIST                ; view contents of an ADF
  105.  
  106. Copyright
  107. ---------
  108.  
  109. UnADF is Copyright © 1999 Andrew Bell. All rights reserved.
  110.  
  111. UnADF is FREEWARE, this means you can copy it as many times as you like
  112. as long as no profit is gained from it's distribution and all of the files
  113. remain together in their original and unmodified state. You are not allowed
  114. to distribute modifed versions of UnADF or it's related files.
  115.  
  116. With the rise of WinUAE, a lot of illegal ADF files have appeared on the
  117. Internet that contain copyrighted material, mainly games. I received a
  118. lot of emails assuming that FloppyFlux had been designed for storing such
  119. ADFs, let me put the record straight, I DID NOT! Both FloppyFlux and
  120. UnADF were designed for storing and handling personal disk collections
  121. such as PD or magazine floppy disks, and not illegal ADFs from pirate web
  122. sites.
  123.  
  124. The author does not condone the use of illegal ADFs with UnADF or FloppyFlux.
  125.  
  126. Author
  127. ------
  128.  
  129. My name is Andrew Bell and you can contact me via email at:
  130.  
  131. -- andrew.ab2000@bigfoot.com
  132.  
  133. Or to get the latest version of this program and to see my other work you
  134. can visit my web page at:
  135.  
  136. -- http://www2.prestel.co.uk/ab2000
  137.  
  138. Enjoy! :-)
  139.  
  140.  
  141. ============================= Archive contents =============================
  142.  
  143. Original  Packed Ratio    Date     Time    Name
  144. -------- ------- ----- --------- --------  -------------
  145.    18024    9553 46.9% 29-Dec-99 16:34:42 +UnADF
  146.     5201    2412 53.6% 29-Dec-99 16:34:42 +UnADF.readme
  147. -------- ------- ----- --------- --------
  148.    23225   11965 48.4% 30-Dec-99 02:43:16   2 files
  149.